package com.alibaba.springbootrbac.service;

import com.alibaba.springbootrbac.model.entity.Role;
import com.alibaba.springbootrbac.model.entity.User;
import com.alibaba.springbootrbac.model.param.user.*;
import com.alibaba.springbootrbac.model.response.user.UserInfoVO;
import com.alibaba.springbootrbac.model.response.user.UserLoginVO;
import com.alibaba.springbootrbac.model.response.user.UserRegisterVO;
import com.baomidou.mybatisplus.core.metadata.IPage;

import java.util.List;

/**
 * 用户管理接口
 */
public interface UserService {

    /**
     * 用户注册
     * @param param 注册信息
     */
    UserRegisterVO register(UserRegisterParam param);


    /**
     * 用户登录
     * @param param 登录请求参数
     * @return 登录请求VO
     */
    UserLoginVO login(UserLoginParam param);

    /**
     * 用户注销
     * @param token 用户登录凭证
     */
    void logout(String token);

    /**
     * 根据username查询用户信息（用于登录接口）
     * @param username
     * @return
     */
    User queryByUserName(String username);

    /**
     * 删除用户信息-逻辑删除
     * @param id 主键ID
     */
    void deleteUserById(String id);

    /**
     * 批量删除用户信息-逻辑删除
     * @param ids 用户主键列表
     */
    void deleteUserByIds(List<String> ids);


    /**
     * 根据主键ID更新用户信息-使用乐观锁控制并发
     * @param param 用户信息
     */
    void updateUserById(UpdateUserParam param);

    /**
     * 根据主键ID查询用户详情
     * @param id 主键ID
     */
    UserInfoVO getUserInfoById(String id);


    /**
     * 查询所有的用户详情-分页查询
     * @param pageQueryParam 条件
     * @return 分页结果
     */
    IPage<UserInfoVO> getUsersInfoByPage(UserPageQueryParam pageQueryParam);

    /**
     * 给用户分配角色
     * @param param 用户分配角色参数
     */
    void assignRolesToUser(UserRoleParam param);

    /**
     * 删除用户和角色的关联关系
     * @param param 用户角色参数
     */
    void removeUserRoles(UserRoleParam param);

    /**
     * 根据用户ID查询用户拥有的权限标识列表
     * @param userId 用户ID
     * @return 权限标识列表
     */
    List<String> getUserPermissions(String userId);


    /**
     * 根据用户ID查询用户拥有的角色列表
     * @param userId 用户ID
     * @return 角色列表
     */
    List<Role> getUserRoles(String userId);

}
